Payin by PSE - TwoPay

Request

Header Params

Authorization

string

optional

token (obtained through co/v1/oauth2/token)
Format: Bearer+" "+ tokens

x-api-key

string

optional

We will provide relevant data in the email

Body Params application/json

uniqueKey

string

required

Unique identification ID of the transaction (each request must be guaranteed to be different)

bankCode

string

required

PSE bank code

name

string

required

Payer's name

phone

string

required

Payer's phone

email

string

required

Payer's email

document

string

required

Payer's document number

documentType

string

required

Payer's document type:CC CE NIT

amount

string

required

amount

address

string

required

Payer's address

remarks

string

required

remarks

encryptStr

string

required

(uniqueKey+document+amount) encrypted string, encrypted salt is provided by us

Example

{
    "uniqueKey": "string",
    "bankCode": "string",
    "name": "string",
    "phone": "string",
    "email": "string",
    "document": "string",
    "documentType": "string",
    "amount": "string",
    "address": "string",
    "remarks": "string",
    "encryptStr": "string"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://test-cn.your-api-server.com/co/v1/payment/pse' \
--header 'Authorization;' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uniqueKey": "string",
    "bankCode": "string",
    "name": "string",
    "phone": "string",
    "email": "string",
    "document": "string",
    "documentType": "string",
    "amount": "string",
    "address": "string",
    "remarks": "string",
    "encryptStr": "string"
}'

Responses

🟢200response

application/json

Body

code

enum<integer> <int32>

required

code: 200, request success 401,request fail

Allowed values:

200401

Default:

200

Example:

200

message

string

required

When the response code is 200, the content is "SUCCESS" If the response code is not 200, an error message is displayed

data

object

required

Specific response content

uniqueKey

string

required

Unique identification ID of the transaction (each request must be guaranteed to be different)

bankCode

string

required

PSE bank code

name

string

required

Payer's name

phone

string

required

Payer's phone

email

string

required

Payer's email

document

string

required

Payer's document number

documentType

string

required

Payer's document type:CC CE NIT

amount

string

required

amount

address

string

required

Payer's address

remarks

string

required

remarks

encryptStr

string

required

(uniqueKey+document+amount) encrypted string, encrypted salt is provided by us

pseUrl

string

required

Once this field is obtained, you need to redirect the buyer to the URL to complete the transaction at the appropriate financial institution (this field has a value when it is PSE's repayment status query)

Example

{
    "code": 200,
    "message": "string",
    "data": {
        "uniqueKey": "string",
        "bankCode": "string",
        "name": "string",
        "phone": "string",
        "email": "string",
        "document": "string",
        "documentType": "string",
        "amount": "string",
        "address": "string",
        "remarks": "string",
        "encryptStr": "string",
        "pseUrl": "string"
    }
}