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"
  },
  "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
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 due to compliance restrictions. Contact Gowd Compliance for details.
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.