Update user status

curl -X POST https://sandbox.trustly.one/api/v1/transactions/transactionId/feedback \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "status": 4,
  "subStatus": 559,
  "description": "Registered"
}'

{
  "transactionId": "string",
  "transactionType": 0,
  "payment": {
    "paymentId": "string",
    "paymentType": 1,
    "merchant": {
      "merchantId": "string",
      "name": "string"
    },
    "merchantReference": "string",
    "merchantId": "string",
    "fingerprint": "string",
    "verification": {
      "status": 1,
      "mode": 1,
      "verifyCustomer": true
    },
    "account": {
      "providerId": "string",
      "paymentProvider": {
        "name": "string",
        "paymentProviderId": "string",
        "type": 1.1,
        "instantPayoutAvailable": true,
        "subType": 1000,
        "swift": "string",
        "address": {
          "country": "string",
          "address1": "string",
          "address2": "string",
          "city": "string",
          "state": "string",
          "zip": "string"
        },
        "country": "US",
        "instantPayment": true
      },
      "country": "US",
      "name": "string",
      "type": 1.1,
      "profile": 1.1,
      "accountNumber": "string",
      "iban": "string",
      "verified": true,
      "verification": {
        "verified": true,
        "type": 1,
        "hasEnoughFunds": true,
        "verificationDate": 1,
        "score": 0,
        "thirdPartyScore": 0,
        "numberOfTries": 1.1,
        "numberOfAttemptsLeft": 1.1
      },
      "source": 1.1,
      "routingNumber": "string",
      "token": "string",
      "accountNumberLastFour": "string",
      "virtualAccountRoutingPair": true
    },
    "currency": "USD",
    "amount": "string",
    "paymentProvider": {
      "name": "string",
      "paymentProviderId": "string",
      "type": 1.1,
      "instantPayoutAvailable": true,
      "subType": 1000,
      "swift": "string",
      "address": {
        "country": "string",
        "address1": "string",
        "address2": "string",
        "city": "string",
        "state": "string",
        "zip": "string"
      },
      "country": "US",
      "instantPayment": true
    },
    "allowedPaymentProviderType": [
      1
    ],
    "auth": {
      "token": "string",
      "status": 1,
      "message": "string"
    },
    "authorization": "string",
    "authorizationStatus": 1.1,
    "authorizationStatusMessage": "string",
    "pending": "string",
    "paid": "string",
    "refunded": "string",
    "reversed": "string",
    "balance": "string",
    "createdAt": 1,
    "updatedAt": 1,
    "recordVersion": 1.1,
    "paymentFlow": 1.1,
    "description": "string",
    "returnUrl": "string",
    "cancelUrl": "string",
    "customer": {
      "name": "string",
      "address": {
        "country": "string",
        "address1": "string",
        "address2": "string",
        "city": "string",
        "state": "string",
        "zip": "string"
      },
      "phone": "string",
      "email": "string",
      "taxId": "string",
      "dateOfBirth": "string",
      "createdAt": 1,
      "updatedAt": 1,
      "customerId": "string",
      "externalId": "string",
      "merchantId": "string",
      "enrollDate": 1,
      "vip": "string",
      "currency": "string",
      "balance": "string",
      "organizationNumber": "string",
      "externalTier": "string",
      "personId": "string",
      "customData": {},
      "driverLicense": {
        "number": "string",
        "state": "string"
      },
      "nationalId": "string"
    },
    "address": {
      "country": "string",
      "address1": "string",
      "address2": "string",
      "city": "string",
      "state": "string",
      "zip": "string"
    },
    "recurrence": {
      "startDate": "2024-01-15T09:30:00Z",
      "endDate": "2024-01-15T09:30:00Z",
      "nextOccurrence": "2024-01-15T09:30:00Z",
      "recurringAmount": "string",
      "debtSettlement": "string",
      "frequency": 1,
      "frequencyUnit": 1.1,
      "frequencyUnitType": "Day",
      "automaticCapture": true,
      "recurrenceId": "string"
    },
    "system": -1,
    "country": "US",
    "paymentProviderSubtype": 1000
  },
  "currency": "USD",
  "amount": "string",
  "pending": "string",
  "paid": "string",
  "refunded": "string",
  "reversed": "string",
  "balance": "string",
  "paymentProviderTransaction": {
    "paymentProviderTransactionId": "string",
    "status": "string",
    "statusMessage": "string",
    "signature": "string",
    "statusDescription": "string",
    "paymentProcessor": {
      "paymentProcessorId": "string",
      "type": 1,
      "name": "string",
      "shortName": "string",
      "url": "string",
      "active": "string"
    },
    "thirdPartyDeclineCode": "string",
    "clearingHouse": "string",
    "instantSettle": true
  },
  "status": 0,
  "statusMessage": "string",
  "ip": "string",
  "createdAt": 1,
  "processedAt": 1,
  "completedAt": 1,
  "updatedAt": 1,
  "merchantReference": "string",
  "recordVersion": 1.1,
  "ppTrxId": "string",
  "expiredAt": 1,
  "originalTransactionId": "string",
  "fee": "string",
  "timeZone": "string",
  "representmentScheduledAt": 1.1,
  "paymentProcessorType": "string",
  "statusCode": "string",
  "preAuthorized": true
}

To confirm a user was registered, set properties status to 4, subStatus to 559 and description to Registered. To void a user who did not complete registration after completing the Trustly ID flow, set status to 13, subStatus to 558 and description to Known bad user.

for more information about Trustly ID, see Verify identity with Trustly ID.

This endpoint updates the status of a user by posting feedback data to Trustly for an authorized Identity transaction. This communicates to Trustly that the user associated with the transaction has been successfully registered in the merchant system, or that the user record has been voided and therefore will not be eligible for future payment transactions. To confirm a user was registered, set properties `status` to `4`, `subStatus` to `559` and `description` to `Registered`. To void a user who did not complete registration after completing the Trustly ID flow, set `status` to `13`, `subStatus` to `558` and `description` to `Known bad user`. for more information about Trustly ID, see [Verify identity with Trustly ID](/integrate/retrieve-data/trustly-id).

Authentication

AuthorizationBasic

Path parameters

transactionIdstringRequired

Transaction ID retrieved from a Trustly Authorization transaction.

Request

This endpoint expects an object.

statusintegerOptionalDefaults to 4

subStatusintegerOptionalDefaults to 559

descriptionstringOptionalDefaults to Registered

Response

transactionIdstring>=1 character

A unique transaction identifier generated by Trustly (15 character max).

transactionTypeenum

Type of transaction record. See Transaction Types

paymentobject

A Trustly Payment

currencyenum

3-letter ISO Currency Code. Currently only USD is supported.

Allowed values:

amountstring>=1 character

The amount of the transaction. (10 characters with support for 2 decimal places)

pendingstring>=1 character

The total amount that is still pending completion. (10 characters with support for 2 decimal places)

paidstring>=1 character

The total amount that was already paid. (10 characters with support for 2 decimal places)

refundedstring>=1 character

The total amount that was refunded. (10 characters with support for 2 decimal places)

reversedstring>=1 character

The total amount that was reversed. (10 characters with support for 2 decimal places)

balancestring>=1 character

The balance of the amount paid, minus the amount reversed and/or refunded. (10 characters with support for 2 decimal places)

paymentProviderTransactionobject

Payment Provider Transaction

statusenum

Status code of the Payment Provider Transaction record. See Transaction Types

statusMessagestring>=1 character

A descriptive status message. (120 characters)

ipstring>=1 character

The client IP address in IPv4 or IPv6 format.

createdAtinteger

The date and time the transaction was created as a UNIX timestamp.

processedAtinteger

The date and time the transaction was processed as a UNIX timestamp.

completedAtinteger

The date and time the transaction was completed as a UNIX timestamp.

updatedAtinteger

The date and time the transaction was last updated as a UNIX timestamp.

merchantReferencestring>=1 character

Merchants internal reference id for the transaction.

recordVersiondouble

The current record version.

ppTrxIdstringOptional>=1 character

internal use only

expiredAtintegerOptional

The date and time the preauthorization will expire as a UNIX timestamp.

originalTransactionIdstringOptional

feestringOptional

timeZonestringOptional

representmentScheduledAtdoubleOptional

paymentProcessorTypestringOptional

statusCodestringOptional

preAuthorizedbooleanOptional

Errors

401

Unauthorized Error