4-Send Payment
This ':id' refers to 'latam_id' generated in step 1
PUT /api/v1/3ds/order/:id
Host: latamgateway.com
Content-Type: "application/json"
ACCOUNT_TOKEN: "<token>"
{
"address": {
"street": "Av Marechal Camara",
"number": "160",
"neighborhood": "Centro",
"complement": "Sala 934",
"zip": "20020080",
"city": "Rio de Janeiro",
"state": "RJ"
},
"credit_card": {
"holder_name": "CUSTOMER F NAME",
"card_number": "4111111111111111",
"cvv": "123",
"due_date": "04/27",
"brand": "visa",
"installments": 3
},
"credentials": {
"payment_method_nonce": "d9745a74-7054-104d-72c7-e4eaf1f274ec"
}
}
Params descriptions
Field | Description | Value Type | Requirement |
---|---|---|---|
address.street |
Street name of the address | String | Required |
address.number |
Number of the address | String | Required |
address.neighborhood |
Neighborhood of the address | String | Required |
address.complement |
Address complement | String | Required |
address.zip |
ZIP code of the address | String | Required |
address.city |
City of the address | String | Required |
address.state |
State abbreviation of the address | String | Required |
credit_card.holder_name |
Name of the credit card holder | String | Required |
credit_card.card_number |
Credit card number | String | Required |
credit_card.cvv |
Credit card CVV code | String | Required |
credit_card.due_date |
Credit card expiration date | String | Required |
credit_card.brand |
Credit card brand | String | Required |
credit_card.installments |
Number of installments for payment | Integer | Optional |
credentials.payment_method_nonce |
Nonce obtained in step 3 | String | Required |
On a successful request, the response will include the following parameters:
{
"latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
"status": "waiting_payment"
}
Business errors are returned with a 400 status code. The response will contain the following parameters:
{
"message": "message of validations errors"
}
Compliance validation errors, including KYC-related issues, are returned with an HTTP 403 status code. The response will contain the following parameters:
{
"latam_id": "7c0b8129-f556-4357-bb6e-8189c2943024",
"message": "message table below",
"code": "code table below"
}
Cancellation Scenarios
Scenario | code |
message |
---|---|---|
Month's limit reached | AML-01 | AML-01: Customer has reached month’s purchase limit |
Semester's limit reached | AML-02 | AML-02: Customer has reached semester’s purchase limit |
Suspicious case | GL-01 | GL-01: Suspicious Case - Customer under investigation for unusual activities |
Legacy | GL-02 | GL-02: Legacy case. Please check with Gowd Compliance team |
Other reasons | GL-03 | GL-03: Customer blocked by Gowd Compliance team for a custom reason. Contact Gowd Compliance for details |
RFI | BL-01 | BL-01: RFI - Customer under investigation by Gowd Compliance team |
Dispute | BL-02 | BL-02: Dispute - Customer or issuing bank disputed a transaction payment |
Multiple disputes | BL-03 | BL-03: Disputes - Multiple disputes opened by the Customer or their issuing bank |
Antifraud | BL-04 | BL-04: Antifraud - Customer blocked by the Gowd antifraud engine |
Internal decision | BL-05 | BL-05: Customer blocked by Gowd Compliance team decision |
Judicial decision | BL-06 | BL-06: Customer blocked by judicial decision |
Judicial/administrative processes | BL-07 | BL-07: Customer blocked due to judicial or administrative processes |
BL - Other reason | BL-08 | BL-08: Customer blocked by Gowd Compliance team for a custom reason. Contact Gowd Compliance for details |
MED | BL-09 | BL-09: MED - Customer blocked due to a MED dispute |
Payer blocked | BL-10 | BL-10: Payer blocked by LG Compliance team decision |
Partner restriction | CR-01 | CR-01: Customer blocked by partner request |
Payment Method restriction | CR-02 | CR-02: Customer blocked from transacting with this payment method |
Maximum number of orders of the day reached | AF-01 | AF-01: Customer has reached the maximum number of daily orders |
Maximum daily purchase amount reached | AF-02 | AF-02: Customer has reached the maximum purchase amount for the day |
Maximum amount for first order of the day reached | AF-03 | AF-03: Customer has reached the maximum purchase amount for the first order of the day |
Divergence of documents | NM-01 | NM-01: Customer’s document does not match the payer’s |
Divergence of names | NM-02 | NM-02: Customer’s name does not match the payer’s |
Invalid CPF | KYC110 | Invalid CPF, please verify your date of birth and CPF number. |
Unregistered CPF | KYC110 | CPF document not found. |
Deceased holder | KYC110 | CPF document belongs to a deceased holder. Year of death: 2024. |
CPF Document suspended | KYC110 | CPF document is suspended. |
Invalid CNPJ | KYC111 | Invalid CNPJ, please verify your CNPJ number. |
Different name in Receita Federal | KYC112 | Different name from the federal revenue register of natural persons. |