1-Initialize Order
Introduction
This flow allows for credit card payments with 3DS verification to be made by using the provided Javascript.
Generate Orders
Creating a Credit Card Paypal TRANSPARENT order:
POST /api/v1/3ds/order
Host: sulpayments.ch
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"
{
"customer": {
"name": "Customer’s full name",
"document": "111.222.333-44", # (required)
"email": "[email protected]", # (required)
"phone": "11999999999", # (required)
"birth": "1996-03-09" # (optional, but we strongly recommend you send it)
},
"order":{
"code": "123", # Order reference in your system (required)
"notification_url": "your_payback_notification_url.com", # Where we'll notify when status changes (required)
"value": 50.00, # (required)
"additional_info": "Some description of your order as String", # (required)
"payment_method": "paypal_card" # (required)
}
}
The response will contain the following parameters:
{
"latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
"status": "initial"
}
Business errors are returned with a 403 status code. The response will contain the following parameters:
{
"latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
"message": "kyc message table below",
"code": "kyc code table below"
}
KYC RESPONSE CODES DESCRIPTIONS
Code | Message |
---|---|
KYC110 | Invalid CPF, please verify your date of birth and CPF number. |
KYC111 | Invalid CNPJ, please verify your CNPJ number. |
KYC112 | Different name from the federal revenue register of natural persons. |