Skip to main content
POST
/
receivers
/
{id}
/
kyc
/
submit
Envia documentos de KYC (multipart/form-data)
curl --request POST \
  --url https://api.astronpay.co/api/v1/receivers/{id}/kyc/submit \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --header 'x-api-secret: <api-key>' \
  --form documentType=rg \
  --form selfie='@example-file' \
  --form documentFront='@example-file' \
  --form documentBack='@example-file' \
  --form documentPhoto='@example-file' \
  --form documentDigital='@example-file' \
  --form cnpjCard='@example-file' \
  --form socialContract='@example-file'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "PF",
  "name": "João Silva",
  "document": "12345678901",
  "documentType": "CPF",
  "status": "PENDING",
  "kycStatus": "PENDING",
  "createdAt": "2023-11-07T05:31:56Z",
  "email": "jsmith@example.com",
  "phone": "+5511999999999",
  "limits": {
    "dailyLimitBrl": 50000,
    "dailyTransactionLimit": 20,
    "nightTransactionsEnabled": false
  },
  "walletAddress": "4k5d...Solana",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
x-api-key
string
header
required
​
x-api-secret
string
header
required

Path Parameters

​
id
string<uuid>
required

Body

multipart/form-data
​
documentType
enum<string>
required

Tipo de documento de identidade pessoal do receiver ou sócio.

Available options:
rg,
cnh
​
selfie
file

Selfie do receiver (obrigatório para PF e PJ).

​
documentFront
file

Frente do RG (obrigatório quando documentType=rg).

​
documentBack
file

Verso do RG (obrigatório quando documentType=rg).

​
documentPhoto
file

Foto da CNH (uma das duas opções quando documentType=cnh).

​
documentDigital
file

CNH digital (uma das duas opções quando documentType=cnh).

​
cnpjCard
file

Cartão CNPJ (obrigatório para receivers PJ).

​
socialContract
file

Contrato social (obrigatório para receivers PJ).

Response

Documentos recebidos; KYC em análise

​
id
string<uuid>
required
​
merchantId
string<uuid>
required
​
type
enum<string>
required
Available options:
PF,
PJ
​
name
string
required
Example:

"João Silva"

​
document
string
required
Example:

"12345678901"

​
documentType
enum<string>
required
Available options:
CPF,
CNPJ
​
status
enum<string>
required
Available options:
PENDING,
ACTIVE,
SUSPENDED,
BLOCKED
​
kycStatus
enum<string>
required
Available options:
PENDING,
SUBMITTED,
UNDER_REVIEW,
APPROVED,
REJECTED
​
createdAt
string<date-time>
required
​
email
string<email> | null
​
phone
string | null
Example:

"+5511999999999"

​
limits
object
​
walletAddress
string | null
Example:

"4k5d...Solana"

​
updatedAt
string<date-time>