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"
}