Update user status

post https://sandbox.trustly.one/api/v1/transactions/{transactionId}/feedback

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.

See the Trustly ID tutorial for more details.

Responses

Response body

object

required

string

transactionId

string

length ≥ 1

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

transactionType

number

Type of transaction record. Definitions and descriptions can be found in this table

1 2 3 4 5 6 7 8 10

payment

object

A Trustly Payment

required

string

paymentId

string

length ≥ 1

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

paymentType

integer

Financial Institution Account Type:

1: Instant - Instant payment. The debit instruction is automatically initiated with that day's batch after consumer authorization.
2: Deferred - Deferred payment. Payment is authorized but the capture operation must be called to initiate the debit. You can start to initiate multiple captures that are less than or equal to the original transaction authorization amount.
3: Recurring - Recurring payment. Same as deferred but associated to a payment agreement between consumer and merchant that defines how much and when the capture can be started.
4: Disbursement - Disbursement payment. This payment type can only be used for disbursements.
5: Verification - This payment type is used to verify the customer financial institution account as the payments will be done outside of the Trustly system.
6: Retrieval Data retrieval. This payment type is used to retrieve account and user information from Trustly without an associated payment request. This payment type is not enabled by default. Contact Trustly if you need this feature.

1 2 3 4 5 6

merchant

object

merchantReference

string

length ≥ 1

An external reference from the merchant. Ex: Order identifier from merchant e-commerce application.

merchantId

string

length ≥ 1

Your Trustly Merchant Id. It will be provided to you.

fingerprint

string

length ≥ 1

Internal use only

verification

object

account

object

description

string

length ≥ 1

A summary description of the order.

returnUrl

string

length ≥ 1

Return URL provided with the bank authorization.

cancelUrl

string

length ≥ 1

Cancel URL provided with the bank authorization.

currency

string

length ≥ 1

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

USD

amount

string

length ≥ 1

The total amount of the order, including tax and shipping. If transactionType is Recurring, this is the Setup Fee Amount.

paymentProvider

object

Details of the Financial institution

allowedPaymentProviderType

array of integers

allowedPaymentProviderType

auth

object

authorization

string

length ≥ 1

Authorization token.

authorizationStatus

number

Status of the related bank authorization. See Transaction Status Values.

authorizationStatusMessage

string

length ≥ 1

Status message of the related bank authorization.

pending

string

length ≥ 1

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

paid

string

length ≥ 1

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

refunded

string

length ≥ 1

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

reversed

string

length ≥ 1

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

balance

string

length ≥ 1

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

createdAt

integer

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

updatedAt

integer

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

recordVersion

number

The current record version.

paymentFlow

number

internal use only

customer

object

Base level end user definition

address

object

Valid mailing or billing address associated with the customer

recurrence

object

Recurring payment options

system

integer

Financial Institution Account Type:

-1: None
1: PayWithMyBank
2: TrustlyAB

-1 1 2

country

string

2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported.

US CA UK DE AU

paymentProviderSubtype

integer

Payment Provider Subtype:

1000: EasyOnline
2000: MEC
2001: MCD

1000 2000 2001

currency

string

length ≥ 1

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

USD

amount

string

length ≥ 1

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

pending

string

length ≥ 1

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

paid

string

length ≥ 1

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

refunded

string

length ≥ 1

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

reversed

string

length ≥ 1

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

balance

string

length ≥ 1

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

paymentProviderTransaction

object

Payment Provider Transaction

paymentProviderTransactionId

string

Unique payment provider transaction identifier.

status

string

See Payment Provider Transaction Status Codes.

statusMessage

string

Payment provider transaction status message.

signature

string

statusDescription

string

paymentProcessor

object

thirdPartyDeclineCode

string

clearingHouse

string

instantSettle

boolean

Whether instant settlement was used for transaction.

status

integer

Status code of the Payment Provider Transaction record. Definitions and descriptions can be found in this table

1 2 3 4 5 6 7 8 10 11 12 13 14

statusMessage

string

length ≥ 1

A descriptive status message. (120 characters)

string

length ≥ 1

The client IP address in IPv4 or IPv6 format.

createdAt

integer

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

processedAt

integer

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

completedAt

integer

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

updatedAt

integer

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

ppTrxId

string

length ≥ 1

internal use only

merchantReference

string

length ≥ 1

Merchants internal reference id for the transaction.

expiredAt

integer

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

recordVersion

number

The current record version.

originalTransactionId

string

fee

string

timeZone

string

representmentScheduledAt

number

paymentProcessorType

string

statusCode

string

preAuthorized

boolean

200OK

401Access not authorized