Payment

Payment order creation

/api/v3/payment/create POST

!Matters needing attention

In some countries, the payment completion status is not linked to the order amount. When the order status is "PAID", it does not mean that the order amount (amount field) has been completely sold. Please refer to the actual transaction amount (paidAmount field). For details, please consult the staff

request parameter

body parameters(application/json)

Returning Responses

Payment order query

/api/v3/payment/query GET

request parameter

url parameters

Returning Responses

Payment order list query

/api/v3/payment/order/list GET

request parameter

url parameters

Returning Responses

Payin Extra Parameters

(BRL) Brazil

// payMethod: PIX
{
  "payerCPF": "xxx", // Payer CPF
  "payerName": "xxx", // Payer Name
}

(COP) Colombia

// payMethod: PSE
{
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number (10 digits)
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user type. Allowed values: CC, TI, CE, PA, NIT
  "bankCode": "xxx", // Bank code
}

// payMethod: NEQUI
{
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number (10 digits)
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user type. Allowed values: CC, TI, CE, PA, NIT
  "accountNo": "xxx", // NEQUI Wallet Account
}

// payMethod: BREB
{
  "customerName": "xxx", // Nome do cliente
  "customerPhone": "xxx", // Número de celular do cliente (10 dígitos)
  "customerEmail": "xxx", // E-mail do cliente
  "documentNumber": "xxx", // número de identificação do usuário
  "documentType": "xxx", // tipo de usuário. Valores permitidos: CC, TI, CE, PA, NIT
}

(MXN) Mexico

// payMethod: CLABE
{
  "repeat": false, // Whether to receive payment repeatedly (bool value)
  "minAmount": 0, // [Optional] Minimum allowable payment amount
  "maxAmount": 0 // [Optional] Maximum allowable payment amount
}

// payMethod: OXXO
{} // No data available, can be ignored

// payMethod: CASH
{} // No data available, can be ignored

(CLP) Chile

// payMethod: WEBPAY
{
  "customerName": "xxx", // Customer Name
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. RUT: Tax number, PAS: Passport
}

// payMethod: KHIPU
{
  "customerName": "xxx", // Customer Name
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. RUT: Tax number, PAS: Passport
}

// payMethod: MACH
{
  "customerName": "xxx", // Customer Name
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. RUT: Tax number, PAS: Passport
}

// payMethod: PAGO46
{
  "customerName": "xxx", // Customer Name
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. RUT: Tax number, PAS: Passport
}

(PEN) Peru

// payMethod: BANKTRANSFER
{
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number (9 digits)
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CE: Foreigner ID card, RUC: Tax number, PAS: Passport
}

// payMethod: CASH
{
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number (9 digits)
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CE: Foreigner ID card, RUC: Tax number, PAS: Passport
}

// payMethod: EWALLET
{
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number (9 digits)
  "customerEmail": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CE: Foreigner ID card, RUC: Tax number, PAS: Passport
}

(TRY) Turkey

// payMethod: BANKTRANSFER
{
  "customerId": "xxx", // Customer ID
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number
  "customerEmail": "xxx", // Customer Email
}

// payMethod: PAPARA
{
  "customerId": "xxx", // Customer ID
  "customerName": "xxx", // Customer Name
  "customerPhone": "xxx", // Customer's mobile phone number
  "customerEmail": "xxx", // Customer Email
}

// payMethod: CREDITCARD_EU
{
  "cardNo": "5555555555554444", // Card number
  "cardType": "MASTERCARD", // Card type. Only MASTERCARD is supported for TRY
  "cardCcv": "123", // Card security code (3 digits)
  "cardExpMonth": "12", // Card expiry month, format MM
  "cardExpYear": "2029", // Card expiry year, format YYYY
  "firstName": "xxx", // Cardholder first name
  "lastName": "xxx", // Cardholder last name
  "country": "TR", // Country code, ISO 3166-1 alpha-2
  "city": "xxx", // City
  "address": "xxx", // Billing address
  "phone": "xxx", // Customer's mobile phone number
  "postcode": "xxx", // Postal code
  "email": "xxx", // Customer Email
  "userIp": "xxx", // Customer IP address
  "userAgent": "xxx" // Customer browser User-Agent
}

// payMethod: CREDITCARD_NON_EU
{
  "cardNo": "5555555555554444", // Card number
  "cardType": "MASTERCARD", // Card type. Only MASTERCARD is supported for TRY
  "cardCcv": "123", // Card security code (3 digits)
  "cardExpMonth": "12", // Card expiry month, format MM
  "cardExpYear": "2029", // Card expiry year, format YYYY
  "firstName": "xxx", // Cardholder first name
  "lastName": "xxx", // Cardholder last name
  "country": "TR", // Country code, ISO 3166-1 alpha-2
  "city": "xxx", // City
  "address": "xxx", // Billing address
  "phone": "xxx", // Customer's mobile phone number
  "postcode": "xxx", // Postal code
  "email": "xxx", // Customer Email
  "userIp": "xxx", // Customer IP address
  "userAgent": "xxx" // Customer browser User-Agent
}

(ARS) Argentina

// payMethod: BANKTRANSFER
{
  "firstName": "xxx", // Customer FirstName
  "lastName": "xxx", // Customer LastName
  "email": "xxx", // Customer Email
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CUIT: Tax number
}

// payMethod: QRIS
{
  "firstName": "xxx", // Customer FirstName
  "lastName": "xxx", // Customer LastName
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number (10 digits)
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CUIT: Tax number
}

// payMethod: CVU
{
  "firstName": "xxx", // Customer FirstName
  "lastName": "xxx", // Customer LastName
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number (10 digits)
  "documentNumber": "xxx", // user identification number
  "documentType": "xxx", // user identification type. DNI: ID card, CUIT: Tax number
}

(USD) America

// payMethod: CASHAPP
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "ipAddress": "xxx", // Customer's ip address. 
  "uid": "xxx", // [Optional] Customer ID. 
}

// payMethod: CREDITCARD
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "ipAddress": "xxx", // Customer's ip address. 
  "uid": "xxx", // [Optional] Customer ID. 
}

// payMethod: APPLEPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "ipAddress": "xxx", // Customer's ip address. 
  "uid": "xxx", // [Optional] Customer ID. 
}

// payMethod: GOOGLEPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "ipAddress": "xxx", // Customer's ip address. 
  "uid": "xxx", // [Optional] Customer ID. 
}

(USDT)

// payMethod: USDT-TRC20
{
  "uid": "xxx" // User unique id
}

// payMethod: USDT-ERC20
{
  "uid": "xxx" // User unique id
}

// payMethod: USDT-BEP20
{
  "uid": "xxx" // User unique id
}

(RUB) Russia

// payMethod: P2P
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
} 

// payMethod: SBP
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
} 

// payMethod: TPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
} 

// payMethod: SBERPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
} 

// payMethod: VTBPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
} 

// payMethod: ALFAPAY
{
  "name": "xxx", // Customer name
  "email": "xxx", // Customer Email
  "phone": "xxx", // Customer's mobile phone number
  "document": "xxx", // Customer ID information
  "ipAddress": "xxx", // Customer's ip address. 
}

(EUR) EU

// payMethod: CREDITCARD_EU
{
  "cardNo": "5555555555554444", // Card number
  "cardType": "MASTERCARD", // Card type
  "cardCcv": "123", // Card security code (3 digits)
  "cardExpMonth": "12", // Card expiry month, format MM
  "cardExpYear": "2029", // Card expiry year, format YYYY
  "firstName": "xxx", // Cardholder first name
  "lastName": "xxx", // Cardholder last name
  "country": "EU", // Country code, ISO 3166-1 alpha-2
  "city": "xxx", // City
  "address": "xxx", // Billing address
  "phone": "xxx", // Customer's mobile phone number
  "postcode": "xxx", // Postal code
  "email": "xxx", // Customer Email
  "userIp": "xxx", // Customer IP address
  "userAgent": "xxx" // Customer browser User-Agent
}

// payMethod: CREDITCARD_NON_EU
{
  "cardNo": "5555555555554444", // Card number
  "cardType": "MASTERCARD", // Card type
  "cardCcv": "123", // Card security code (3 digits)
  "cardExpMonth": "12", // Card expiry month, format MM
  "cardExpYear": "2029", // Card expiry year, format YYYY
  "firstName": "xxx", // Cardholder first name
  "lastName": "xxx", // Cardholder last name
  "country": "EU", // Country code, ISO 3166-1 alpha-2
  "city": "xxx", // City
  "address": "xxx", // Billing address
  "phone": "xxx", // Customer's mobile phone number
  "postcode": "xxx", // Postal code
  "email": "xxx", // Customer Email
  "userIp": "xxx", // Customer IP address
  "userAgent": "xxx" // Customer browser User-Agent
}

USD exchange rate query

/api/v3/payment/usdRate GET

request parameter

url parameters

Returning Responses