Create Transparent Order - V3 | Gowd Platform Sandbox

Authorizations

Bearer

Header Parameters

idempotency-key

required

string format: uuid

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request Body^required

object

customer

required

The customer of the order.

object

fullName

required

The name of the customer, e.g.: [John Doe] or [Acme Corporation].

string

type

required

The type of entity that owns the account.

string

Allowed values: INDIVIDUAL ORGANIZATION

document

required

The document of the Customer.

object

type

required

Type of document, used when providing an ID number.

----------------------------
Brasil
----------------------------
CPF
CNPJ
OTHERS

----------------------------
Mexico
----------------------------
CURP,
RFC

string

Allowed values: CPF CNPJ OTHERS CURP RFC

number

required

The number in the document.

string

email

required

The e-mail address of the Customer.

string

phone

required

The phone number of the Customer.

string

birth

The date of birth or foundation, in ISO-8601 YYYY-MM-DD format.

string

country

required

The country of the Merchant

string

Allowed values: AFG ALB DZA ASM AND AGO AIA ATA ATG ARG ARM ABW AUS AUT AZE BHS BHR BGD BRB BLR BEL BLZ BEN BMU BTN BOL BES BIH BWA BVT BRA IOT BRN BGR BFA BDI CPV KHM CMR CAN CYM CAF TCD CHL CHN CXR CCK COL COM COG COD COK CRI HRV CUB CUW CYP CZE DNK DJI DMA DOM ECU EGY SLV GNQ ERI EST ETH FLK FRO FJI FIN FRA GUF PYF ATF GAB GMB GEO DEU GHA GIB GRC GRL GRD GLP GUM GTM GGY GIN GNB GUY HTI HMD VAT HND HKG HUN ISL IND IDN IRN IRQ IRL IMN ISR ITA JAM JPN JEY JOR KAZ KEN KIR PRK KOR KWT KGZ LAO LVA LBN LSO LBR LBY LIE LTU LUX MAC MDG MWI MYS MDV MLI MLT MHL MTQ MRT MUS MYT MEX FSM MDA MCO MNG MNE MSR MAR MOZ MMR NAM NRU NPL NLD NCL NZL NIC NER NGA NIU NFK MNP NOR OMN PAK PLW PSE PAN PNG PRY PER PHL PCN POL PRT PRI QAT REU ROU RUS RWA BLM SHN KNA LCA MAF SPM VCT WSM SMR STP SAU SEN SRB SYC SLE SGP SXM SVK SVN SLB SOM ZAF SGS SSD ESP LKA SDN SUR SJM SWE CHE SYR TWN TJK TZA THA TLS TGO TKL TON TTO TUN TUR TKM TCA TUV UGA UKR ARE GBR USA UMI URY UZB VUT VEN VNM VGB VIR WLF ESH YEM ZMB ZWE

address

Address.

object

state

required

State.

string

city

required

City.

string

street

required

Street.

string

neighborhood

required

Neighborhood.

string

number

required

Number.

string

complement

required

Complement.

string

postalCode

required

Postal code.

string

ip

required

IP.

string

order

required

The order details.

object

code

required

Order reference in your system.

string

paymentMethod

required

Payment method

Brazil - BRL

PIX: Instant payment method
BINANCE_PAY: Crypto payment
DEPOSIT: Bank transfer (optional bankSlug field for specific bank selection)
BOLETO: Brazilian bank slip

Mexico - MXN

CREDIT_CARD: Credit card payment
SPEI: Electronic transfer
OXXO: Cash payment at OXXO stores
OXXOPAY: OXXO digital wallet
PAYNET: PayNet payment method

string

Allowed values: PIX DEPOSIT BOLETO BINANCE_PAY CREDIT_CARD SPEI OXXO OXXOPAY PAYNET

amount

required

Amount of the order.

object

currency

required

Currency

string

Allowed values: BRL USD USDT BUSD

value

required

The amount of the transaction, in minor units. Minor Units Format ------------------ All amount values must be formatted in that currency’s smallest unit. Two-decimal currency (for example Real): R$ 10,95 BRL, amount will be “10.95”. Two-decimal currency (for example US Dollars): $10.95 USD, amount will be “10.95”. Zero-decimal currency (for example Japanese Yen): ¥1095 JPY, amount will be “1095”. Click here to download the latest official ISO 4217 Currency Table, with Minor Units (number of decimal places) per currency

string

additionalInfo

required

Some description of your order as String.

string

webhookUrl

required

The URL for order notification.

string

returnUrl

required

The URL for order return after payment Done

string

financialPartner

The financial partner of the order

string

Allowed values: BINANCE_PAY LATAM_PAY MATERA GAMECASH REDPAY PIX_JD

expiration

PIX QRCode expiration limit, with granularity of seconds. This field should only be used to generate dynamic PIX QRCodes. If not filled in, the default value will be 86400 seconds, equivalent to 24 hours.

number

specialPaymentDetails

Special payment details.

object

card3DSToken

3DS authentication token (payment method nonce) returned after completing the 3-D Secure flow. Required by partners such as PayPal/Redpay for credit card payments.

string

cardToken

Tokenized card identifier produced by the card-tokenization process. Use when the payment method expects a stored card token instead of raw card data.

string

creditCard

Credit card data. Use skipThreeDSecure field to control 3DS behavior.

object

holderName

required

Card holder name

string

holderDocument

Card holder document masked with first 3 digits visible (CPF: 11 digits total, CNPJ: 14 digits total)

string

cardNumber

required

Credit card number

string

cvv

required

Card security code (CVV)

string

expirationDate

required

Card expiration date (MM/YY format)

string

brand

required

Card brand (e.g., Visa, Mastercard, Amex, etc.)

string

installments

required

Number of installments

number

>= 1

skipThreeDSecure

Whether to skip 3DS authentication

boolean

default: true

installmentsNumber

Number of installments for credit card payments.

number

browser

Browser data for 3DS authentication.

object

httpAcceptBrowserValue

required

string

httpAcceptContent

required

string

httpBrowserLanguage

required

string

httpBrowserJavaEnabled

required

boolean

httpBrowserJavaScriptEnabled

required

boolean

httpBrowserColorDepth

required

string

httpBrowserScreenHeight

required

string

httpBrowserScreenWidth

required

string

httpBrowserTimeDifference

required

string

userAgentBrowserValue

required

string

bankSlug

Bank identifier for DEPOSIT payments. Optional — if omitted, the default bank will be used. Available banks at GET /v1/orders/deposit/banks.

string

200

The resource was returned successfully

object

id

required

The id of the order create.

string

code

required

Order id in your system.

string

status

required

Order status

string

qrcodeLink

Link image qrCode.

string

qrcodeBase64

Base64 of image qrCode.

string

qrcodeData

String with all pix transaction info needed to be copy and paste into bank app

string

expireDateTime

QrCode expiration DateTime

string

deepLink

Deeplink to open binance app to payment.

string

universalLink

required

Universal url to finish the payment.

string

challengeUrl

Challenge url for 3DS antifraud verification.

string

challengeAccessToken

Challenge access token for 3DS antifraud verification.

string

challengeSetupUrl

Challenge url for 3DS antifraud verification.

string

challengeSetupAccessToken

Challenge access token for 3DS antifraud verification.

string

challengeStatus

Challenge status for 3DS antifraud verification.

string

checkoutLink

Checkout url to finish the payment.

string

token

Order Token

string

fee

Fee

object

fixed

required

Fixed fee amount

object

variable

required

Variable fee amount

object

additional

required

Addictional fee amount

object

errorMessage

Error message

string

amountToPay

required

Final value, which the customer will pay, including fees

string

description

required

Description about the order

string

bankAccount

required

Payment bank account, SPEI only

object

clabe

required

The clabe

string

beneficiary

required

The beneficiary

string

bankCode

required

The bankCode

string

400

The request is not valid

Array<string>

403

Unauthorized Request

Array<string>

404

Resource not found

Array<string>

500

An unexpected error occurred inside the server

Array<string>

Create Transparent Order - V3

Authorizations

Parameters

Header Parameters

Request Body required

Brazil - BRL

Mexico - MXN

Responses

200

400

403

404

500

Request Body^required