APIPayments

Retrieve payment

View as Markdown
Retrieves the details of a Payment. Supply the unique paymentId that was returned from your previous request, and Trustly will return the corresponding payment information.

Authentication

AuthorizationBasic

Path parameters

paymentIdstringRequired

Response

OK
paymentIdstring>=1 character

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

paymentTypeenum

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.
merchantobject
merchantReferencestring>=1 character

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

merchantIdstring>=1 character
Your Trustly Merchant Id. It will be provided to you.
fingerprintstring>=1 character
Internal use only
verificationobject
accountobject
currencyenum

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

amountstring>=1 character
The total amount of the order, including tax and shipping. If transactionType is Recurring, this is the Setup Fee Amount.
paymentProviderobject
Details of the Financial institution
allowedPaymentProviderTypelist of integers
authobject
authorizationstring>=1 character
Authorization token.
authorizationStatusdouble
Status of the related bank authorization. See Transaction Status Values.
authorizationStatusMessagestring>=1 character
Status message of the related bank authorization.
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)

createdAtinteger
The date and time the transaction was created as a UNIX timestamp.
updatedAtinteger
The date and time the transaction was last updated as a UNIX timestamp.
recordVersiondouble
The current record version.
paymentFlowdouble
internal use only
descriptionstring>=1 character
A summary description of the order.
returnUrlstring>=1 character
Return URL provided with the bank authorization.
cancelUrlstring>=1 character
Cancel URL provided with the bank authorization.
customerobject
The Trustly customer object, containing identification details and contact information.
addressobject
Valid mailing or billing address associated with the customer
recurrenceobject
Recurring payment options
systemenum

Financial Institution Account Type:

  • -1: None
  • 1: PayWithMyBank
  • 2: TrustlyAB
countryenum

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.

paymentProviderSubtypeenum

Payment Provider Subtype:

  • 1000: EasyOnline
  • 2000: MEC
  • 2001: MCD