Payins

Create payin

Changed on Mar 12, 2026

Creates a payin (payment intent) for an order. Requires order_id and either type or gateway_id.

For card payments, the response includes a direct_link to the payment page. For bank wire payments, the response includes bank transfer details in provider.

post/payins

Request

Base URL
https://your-subdomain.truust.io/2.0
URL
https://your-subdomain.truust.io/2.0/payins
Auth
HTTP bearer

Request body

order_idinteger required

ID of the order to pay.

typestring required

Payment method type. Valid values include BANKWIRE, WALLET, and any registered gateway type for the account (e.g. REDSYS_V2, ADDON, ADDON_V2, ADDON_ICE, ADDON_HPP, ADDON_APPLE_PAY, AZUPAY, DCP, EPX, REDSYS_APPLE_PAY, REDSYS_AUTH, STRIPE, DOCOMO, SIBS_MBWAY, SIBS_MULTIBANCO, SEQURA, UNNAX, PAYPAL, BIZUM, INESPAY).

gateway_idinteger

Gateway ID to use. Alternative to type.

card_idinteger

Saved card ID to charge (for recurring or one-click payments).

wallet_idinteger

Wallet ID to debit. Required when type is WALLET.

save_card0 | 1

Set to 1 to tokenize and save the card for future use.

Example request

{
  "order_id": 4950,
  "type": "REDSYS_V2",
  "save_card": 1
}

Response

Payin created

idinteger

selfstring

referencestring nullable

Provider's payment reference ID.

typestring

Payment method type (e.g. CARD, BANKWIRE, WALLET).

subtypestring nullable

providerobject

Raw provider response data.

tagstring nullable

direct_linkstring uri nullable

Payment page URL. Only present when status is CREATED or AUTHORIZED.

created_atstring date-time nullable

confirmed_atstring date-time nullable

denied_atstring date-time nullable

connectionsConnections

Hypermedia links to related resources.

Example response

{
  "self": "/2.0/payins/456"
}

Changes

Mar 12, 2026ff825f6602c8 Revision changes
- breaking
  request property was restricted to a list of enum values
- breaking
  the request property became required
- breaking
  removed the enum value BANKWIRE of the request property
- breaking
  removed the enum value CARD of the request property
- breaking
  removed the enum value WALLET of the request property
- breaking
  the request property type changed from boolean to integer
- info
  added the new 0.00 enum value to the request property
- info
  added the new 1.00 enum value to the request property

Operation history