Get a single payment by its origin ID
Returns the single Payment with the given origin-platform ID for an account, in the same shape as GET /activity/payment/{id}. Only that Payment is returned, never the other Payments on its Order; order.metadata.paymentsCount gives how many the Order holds.
Authorizations
Path Parameters
The ID of the Payment on the origin platform. This is the transactionGroupId on the payment's BoxCredited/BoxDebited webhooks.
36"9a623439-8275-4230-a157-6c623a2ea7b8"
Query Parameters
The ID of the account to work with.
"F50091"
Controls which optional properties should be attached to the response. forwardDetails attaches the forward contract's payments, events, deposits and drawdowns to forward contract payments. paymentFiles attaches a paymentFiles array (per UETR); each item has a fileType (mt103/pacs008/pain001/pdf) and a pre-signed url. swiftGpi attaches the SWIFT GPI tracking detail (UETR, status and payment-leg events).
forwardDetails, paymentFiles, swiftGpi "paymentFiles,swiftGpi"
The ID of the person to work with. Use commas to pass multiple values. Has to be URL encoded.
Response
OK
Used to identify this particular type of Order. E.g. when it's part of the "activity" stream. Exchange payments return "currencyPurchase".
payment, currencyPurchase "payment"
The ID of the Payment.
42782085
The ID of the Order the Payment belongs to.
1380
The ID of the User that the Payment belongs to. Can be NULL (PAY Payment for example).
36"34edaf73-49be-4669-83ee-1b1f8c680d26"
The ID of the Company that the Payment belongs to.
36"F50072"
The ID of the Payment on the origin platform. PAY for example
36"9a623439-8275-4230-a157-6c623a2ea7b8"
The order ID of the Order the Payment belongs to on the origin platform. PAY for example
36"EKOBEPVFJ"
The ID of the budget to work with.
36"775596ae-2624-40af-a9dc-9756110a4a03"
The status of the Payment. Currently always the same as the parent Order status.
needsApproval, fundsRequired, pending, complete, declined, reverted, refunded, cancelled, open, cardCheck, fundsSettled "orderCancelled"
Whether this is a single or multi beneficiary payment.
The unique ID of the beneficiary
256"ben90944601"
Name of the Person receiving the Payment.
256"Nichole Grant"
Address of the Person receiving the Payment.
"46315 Bailey MillSouth CamilleNiue"
Bank account number to send the Payment to.
32"10387899"
Sort code of the bank to send the Payment to.
32"12-34-56"
Iban of the bank to send the Payment to.
34"PT72105510150936500020992"
Bank code of the bank to send the Payment to.
256"QHKEMKK1"
Address of the bank the Payment is being made to.
"883 Bernie MountainNew EstachesterVietnam"
The ISO country code for the country the beneficiary is registered to.
"GB"
Extra payment information as to how a payment will be routed.
"Payment will be routed from Barclays Bank and then through Lloyds bank"
Name of the Person send in the Payment.
256"Joseph Bloggs"
Handy reference to describe the Order.
"withdrawal transaction at Osinski, Zboncak and Bayer using card ending with ***3963 for IDR 670.50 in account ***32418758"
The amount the Payment was for. Maximum amount is 9999999999.99.
773.08
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHN, SLE, SLL, SOS, SRD, SSP, STN, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XAG, XAU, XCD, XOF, XPD, XPF, XPT, YER, ZAR, ZMK, ZMW, ZWD "USD"
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHN, SLE, SLL, SOS, SRD, SSP, STN, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XAG, XAU, XCD, XOF, XPD, XPF, XPT, YER, ZAR, ZMK, ZMW, ZWD "USD"
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHN, SLE, SLL, SOS, SRD, SSP, STN, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XAG, XAU, XCD, XOF, XPD, XPF, XPT, YER, ZAR, ZMK, ZMW, ZWD "USD"
When isMultiBeneficiary = false. The amount of the currency being bought including our Fee. Maximum amount is 9999999999.99.
33920.34
When isMultiBeneficiary = false. The total fee we took for the facilitating the purchase.
1.34
When isMultiBeneficiary = false. The amount of the currency being bought excluding our Fee. Maximum amount is 9999999999.99.
33920.34
When isMultiBeneficiary = false. The rate at which the buy currency was bought including any margin. This is the rate the customer sees
0.8637052
When isMultiBeneficiary = false. The rate at which the sell currency was sold including any margin
0.71942446043
When isMultiBeneficiary = false. The key used to identify a pdf confirmation for an order.
"F36555/pdf/F36555-000265963.pdf"
The unique ID of the beneficiary on MTS
256"69e4a1e8-db35-4301-b5a8-67a2cb063609"
The type of the Payment. fee and tax are billing charges raised against an order, not customer-initiated movements.
exchange, payment, cardPayment, deposit, forwardContract, drawdown, load, fee, tax The name of the budget.
The transaction group ID.
"1c0547bd-30e6-4d14-b82e-78cd128fbfd9"
Array of all the box events which belongs to a Payment.
The date the Resource was initially created. ISO 8601 format without milliseconds.
The date the Resource was last modified. ISO 8601 format without milliseconds.
The CIS person UUID of the person who owns this Payment — the same identity the app holds for a logged-in person. Null when no owner is known (never the caller by fallback); distinct from the legacy userId column, which may hold an auth subject on older rows. Absent from older producers.
36"775596ae-2624-40af-a9dc-9756110a4a04"
The customer-defined unique identifier for the payment. Echoes the externalId originally supplied to POST /v2/payments. Absent or null when none was supplied.
1 - 64"cust-ref-9f3b"
Always returns "companyBalance" as the Budget.
companyBalance Unique End-to-end Transaction Reference. Set on payments routed over SWIFT or CHAPS. Not an eligibility signal on its own, since it can be present on payments no confirmation can be produced for. Use paymentConfirmationAvailable to decide whether to offer a confirmation document.
36"eb6305c8-0d2a-4e1e-a30f-3ef5b1e5c2f8"
Whether a payment confirmation document can be produced for this Payment.
true
The network the Payment was routed over. Null where the rail is not known, and for internal transfers, which have no external network.
SWIFT, SEPA.INSTANT, SEPA.CREDITTRANSFER, CHAPS, UKFPS, ACH, WIRETRANSFER, OFF_PLATFORM, NIP "UKFPS"
Used to show if a payment has been deleted (when received from PAY).
Nested forward-contract details. Only populated when include=forwardDetails is requested for forwardContract rows.
Downloadable payment files for the activity, keyed by UETR (one per UETR today). Only populated when include=paymentFiles is requested, for payment and boxTransaction rows.
SWIFT GPI tracking detail for the payment, including the full chain of payment-leg events. Only present for SWIFT/bank payments when include=swiftGpi is specified.
Comma-separated list of team names associated with the payment initiator. Only present when include=teams is specified.