Skip to main content

Confirmation (capture funds)

(POST /all-in-one/confirm)

To make a sale effective through 3D Secure PSD2 compliance, the sale must be confirmed using the request_id obtained from the previous redirection.

Payload

  • request_id (string, required): Identifier of the operation necessary to finalize the sale 59847839cc3ac13489348d9b.

Additional fields can be added to the payload to meet specific use cases (see the section Examples of Payment Flows):

  • previously_authenticated (bool): This field allows for authorizations up to 120 days after the original authentication. It must be set to true.

    • default value: false
  • token (string): Alphanumeric code associated with the card data. It serves to store the card details in the secure vault and facilitate future operations with that card without needing to transmit its data over the network again, thus securing the purchase process. sipay-token-prueba-359ef8ce5c5f4003b71692e446908c27

    • It will not be possible to tokenize a card without having completed a SCA (Strong Customer Authentication) protocol, such as the 3DS 2.X protocol. Therefore, it is not possible to tokenize through operations processed as an exemption.
  • amount (string, required): Amount of the operation 1000

Request example

{
"key": "589365da65c48cff87d0874a",
"resource": "359ef8ce5c5f4003b71692e446908c27",
"nonce": "1234567890",
"mode": "sha256",
"payload": {
"request_id": "5f7b377c6b47f40001641eb3"
}
}

Success - 0 - authentication

  • code (string, required): Internal operation code. Refer to Response Codes 0
  • amount (string, required): Amount of the operation 1000
  • currency (string, required): Currency used in the operation EUR
  • order (string, required): Ticket for the operation sipay-order-001
  • reconciliation (string, required): Identifier for bank reconciliation 1234sipay
  • card_trade (string, required): Issuer of the card. Request more information. undefined
  • card_type (string, required): Type of the card. Request more information. undefined
  • masked_card (string, required): Masked card number 6712 00** ****0205
  • transaction_id (string, required): Transaction identifier. 000024899463550243139
  • sequence (string, required): 1131238
  • authorizator (string, required): Authorizing entity for the operation BANCO SANTANDER, S.A.
  • approval (string, required): Approval code from the entity 346179

Response example

{
"request_id": "59847839cc3ac13489348d9b",
"type": "success",
"code": "0",
"payload": {
"code": "0",
"amount": "10.00",
"currency": "EUR",
"order": "rbm-order-002",
"reconciliation": "1234rbm",
"card_trade": "undefined",
"card_type": "undefined",
"masked_card": "6712 00** ****0205",
"transaction_id": "000097426982123375833",
"sequence": "1769436",
"authorizator": "BANCO SANTANDER, S.A.",
"approval": "346637"
},
"uuid": "18322aca-57f3-46b5-9e1b-b65f603abff8",
"description": "Authentication processed successfully",
"detail": "authentication"
}