Skip to main content
POST
/
v1
/
charges
/
{id}
/
resume-3ds
Resume charge after managed 3DS authentication
curl --request POST \
  --url https://api-global.fastpaybrasil.com/v1/charges/{id}/resume-3ds \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "threeDS": {
    "type": "full",
    "state": "success",
    "mode": "frictionless",
    "cryptogram": "Vt5xwasruB0Q6qRoG9mpzdRPqQs=",
    "eci": "05",
    "version": "2.2.0",
    "directoryServerTransactionId": "607bb317-8d24-45a7-a3c0-7ae1fdca56d0",
    "threeDsServerTransactionId": "59588a8b-955e-4aa8-bae1-338bbfdba8fa",
    "acsTransactionId": "6bf18a7a-3a7b-488f-bce1-3da96c73e746",
    "deviceData": {
      "acceptHeader": "<string>",
      "userAgentHeader": "<string>",
      "browserLanguage": "<string>",
      "browserScreenWidth": 123,
      "browserScreenHeight": 123,
      "browserJavaEnabled": true,
      "browserColorDepth": "<string>",
      "timeZone": "<string>",
      "browserJavascriptEnabled": true,
      "channel": "<string>"
    },
    "challenge": {
      "returnUrl": "https://merchant.com/3ds/return"
    }
  }
}
'
{
  "id": "2vorkDcXyvzifL63YX09S9VqcnI",
  "status": "pending",
  "paymentDetails": {
    "firstSix": "123456",
    "lastFour": "7890",
    "expirationMonth": "08",
    "expirationYear": "2024",
    "holderName": "John Doe",
    "installments": 3
  },
  "reason": "Insufficient funds"
}

Authorizations

​
Authorization
string
header
required

HTTP Basic authentication. Use your secret key as the username and an empty string as password. The API key should be base64 encoded in the format 'username:' when sending the Authorization header.

Path Parameters

​
id
string
required

Charge ID

Example:

"2vorkDcXyvzifL63YX09S9VqcnI"

Body

application/json
​
threeDS
object
required

3D Secure authentication data for BYO-3DS (Bring Your Own) flow. Obtain this object from the FastPay Security SDK or from POST /v1/three-ds/challenge-result after the challenge completes.

Response

Charge resumed and processed

​
id
string
required

The unique identifier of the created charge

Example:

"2vorkDcXyvzifL63YX09S9VqcnI"

​
status
enum<string>
required

The status of the charge

Available options:
paid,
pending,
refused,
failed
Example:

"pending"

​
paymentDetails
Credit Card · object
required

Additional payment details specific to the payment method

​
reason
string | null
required

The reason for charge status (especially for refused charges)

Example:

"Insufficient funds"