Skip to content

Get a payment intent

Request

Retrieves the details of a specific payment intent within a settlement allocation.

Security
ClientCredentialsToken
Path
allocationIdstring^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}...required

Unique identifier of the settlement allocation.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
paymentIntentIdstring^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}...required

Unique identifier of the payment intent.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
curl -i -X GET \
  https://api.wise.com/2026Q4/settlement/allocations/f47ac10b-58cc-4372-a567-0e02b2c3d479/payment-intents/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479'

Responses

Payment intent details retrieved successfully.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Bodyapplication/json
idstring

Unique identifier of the payment intent.

Example:"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
allocationIdstring

Unique identifier of the associated settlement allocation.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
partnerEntityIdstring

Partner entity identifier.

Example:"PARTNER-001"
profileIdstring

Profile identifier.

Example:"12345678"
recipientTypestring

Type of recipient.

Enum:"SELLER""PARTNER_FEE"
sourceAmountnumber, (decimal), > 0

Source amount of the payment.

Example:100
sourceCurrencystring, = 3 characters^[A-Z]{3}$

Source currency code (ISO 4217).

Example:"EUR"
targetAmountnumber, (decimal), > 0

Target amount of the payment.

Example:85
targetCurrencystring, = 3 characters^[A-Z]{3}$

Target currency code (ISO 4217).

Example:"GBP"
allocationTypestring

Type of allocation.

Enum:"CREDIT""DEBIT"
paymentReferencestring

Payment reference.

Example:"REF-001"
reasonstring

Reason for the payment.

Example:"Invoice payment"
statestring

Current state of the payment intent.

Enum:"NEW""PARTIALLY_LEDGERED""LEDGERED""PARTIALLY_SETTLED""SETTLED""CANCELLED"
fundingSourcestring

Source of funding for the payment.

Enum:"WISE_COLLECTION_ACCOUNT""PARTNER_DEFICIT_ACCOUNT""SPLIT""UNDETERMINED"
createdAtstring, (date-time)

Timestamp when the payment intent was created.

Example:"2026-07-10T10:35:16.000Z"
updatedAtstring, (date-time)

Timestamp when the payment intent was last updated.

Example:"2026-07-10T10:45:41.000Z"
Response
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "allocationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "partnerEntityId": "PARTNER-001",
  "profileId": "12345678",
  "recipientType": "SELLER",
  "sourceAmount": 100,
  "sourceCurrency": "EUR",
  "targetAmount": 85,
  "targetCurrency": "GBP",
  "allocationType": "CREDIT",
  "paymentReference": "REF-001",
  "reason": "Invoice payment",
  "state": "NEW",
  "fundingSource": "WISE_COLLECTION_ACCOUNT",
  "createdAt": "2026-07-10T10:35:16.000Z",
  "updatedAt": "2026-07-10T10:45:41.000Z"
}