Skip to content

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.