API Reference

Verify OTP

Request

[POST] /api/v1/transfer/verify-otp
Content-Type: application/json
x-client-id: <client_id>
x-signature: <signature>
x-timestamp: <timestamp>

Body

FieldRequiredTypeDescription
idrequiredstringID
pass_coderequiredstringPass code

Response

Content-Type: application/json

Body

NameTypeDescription
idstringreference id not only
transaction_numberstringTransaction number <-- using for get detail
provider_transaction_numberstringProvider transaction number
provider_payment_numberstringProvider payment number
statusstringwaiting_confirm,processing,success
otp_statusstringpending - trx is processing at bank side
success - trx is completely proceesed
failed- trx is failed fro some reason
settling- trx is awaiting reconciliation on date T+1
remaining_tryint

Errors

StatusMesssage
201Success
401Unauthorized

Example

[POST] /api/v1/transfer/verify-otp

Request

{
    "id": "7fc5e181-aae3-4021-8ce0-6a53aa71990d",
    "pass_code": "1828288371923881984"
}

Response

{
  "message": {
    "content": "Bạn vừa thực hiện tạo thành công %s"
  },
  "code": 102001,
  "request_id": "f3fe9810-c9a9-4f56-93b1-b54ef6dbcac8",
  "data": {
    "id": "f0a446c3-7d7f-46f3-9062-f005dc3718d3",
    "transaction_number": "TXN123456789", // <--- THIS USING TO GET TRANSACTION DETAIL BECAUSE THE ID REFERENCE TO MAIN
    "provider_transaction_number": "PTXN987654321",
    "provider_payment_number": "PPN123456789",
    "status": "processing",
    "otp_status": "pending",
    "remaining_try": 3
  }
}