Khipu

How to use Khipu to submit a payin in Argentina.

Payin by Khipu

POST https://gateway-test.pagsmile.com/trade/pay

This endpoint allows you to submit a payin by Khipu in Argentina.

Headers

Name	Type	Description
Content-Type*	string	application/json; chartset=UTF-8
Authorization*	string	Basic Base($app_id:$security_key)

Name

Type

Description

Content-Type*

string

application/json; chartset=UTF-8

Authorization*

string

Basic Base($app_id:$security_key)

Request Body

Name	Type	Description
app_id*	string	created app's id at dashboard - Max. 32 chars -
customer.phone*	string	User's phone
customer.email*	string	User's email
customer.identify.number*	string	User's identification number - 8 digits or 11 digits -
method*	string	Fixed value: Khipu
out_trade_no*	string	ID given by the merchant in their system - Max. 64 chars -
notify_url*	string	Where Pagsmile will send notification to
customer.identify.type*	string	User's identification type - DNI or CUIT/CUIL/CD -
customer.name*	string	User's name
timestamp*	string	yyyy-MM-dd HH:mm:ss - Max. 19 chars -
subject*	string	payment reason or item title - Max. 128 chars -
order_amount*	string	payment amount - 50~1,257,000 ARS (per day) -
order_currency*	string	Fixed value: ARS
content*	string	payment reason detail or item detail - Max. 255 chars -
buyer_id*	string	merchant user's id
address.zip_code	string	zip code - 6 digits -
website_url	string	merchant website URL - Max. 128 chars -
address.street	string	street
address.street_number	string	street number
address.city	string	city
address.state	string	state
return_url	string	Redirect to Merchant's url when user finished checkout
bank*	string	Use API to get bank code

Name

Type

Description

app_id*

string

created app's id at dashboard

- Max. 32 chars -

customer.phone*

string

User's phone

customer.email*

string

User's email

customer.identify.number*

string

User's identification number - 8 digits or 11 digits -

method*

string

Fixed value: Khipu

out_trade_no*

string

ID given by the merchant in their system - Max. 64 chars -

notify_url*

string

Where Pagsmile will send notification to

customer.identify.type*

string

User's identification type

- DNI or CUIT/CUIL/CD -

customer.name*

string

User's name

timestamp*

string

yyyy-MM-dd HH:mm:ss - Max. 19 chars -

subject*

string

payment reason or item title

- Max. 128 chars -

order_amount*

string

payment amount - 50~1,257,000 ARS (per day) -

order_currency*

string

Fixed value: ARS

content*

string

payment reason detail or item detail

- Max. 255 chars -

buyer_id*

string

merchant user's id

address.zip_code

string

zip code - 6 digits -

website_url

string

merchant website URL

- Max. 128 chars -

address.street

string

street

address.street_number

string

street number

address.city

string

city

address.state

string

state

return_url

string

Redirect to Merchant's url when user finished checkout

bank*

string

Use API to get bank code

{
    "code":"10000",
    "msg":"Success",
    "prepay_id":"d3UwdDhRbnUx****NMzdaWT0=-17FBDFe8",
    "trade_no":"2022010110293900083",
    "out_trade_no":"202201010354006",
    "web_url":"",
    "pay_url":"https://khipu.com/payment/info/ab0cdezzmz3k",
    "trade_status":"PROCESSING"
}

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "duplicate-out_trade_no",
    "sub_msg": "out_trade_no is duplicate"
}

User payment tips

Redirect users to the pay_url to complete the payment
KHIPU works as an interface that connects the user with the Bank platform and simplifies the bank transfer flow, therefore, the user document id, Clave (Password/PIN), and username that users enter on KHIPU should be the same as the one they used to enter their e-banking

Example

curl --location --request POST 'https://gateway-test.pagsmile.com/trade/pay' \
--header 'Authorization: Basic MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ==' \
--header 'Content-Type: application/json' \
--data-raw '{
    * "app_id": "162************38",
    * "out_trade_no": "202201010354006",
    * "method": "Khipu",
    * "order_amount": "50",
    * "order_currency": "ARS",
    * "subject": "trade pay test",
    * "content": "trade pay test conent",
    * "notify_url": "http://merchant/callback/success",
      "return_url": "https://www.merchant.com",
    * "buyer_id": "buyer_0101_0001",
    * "timestamp": "2022-01-01 03:54:01",
      "timeout_express":"1c",
    * "bank" : "Si9wa",    
    * "customer" : {
    *     "identify": {
    *         "type": "DNI",
    *         "number": "40754127"
          },
    *     "name": "Test User Name",
    *     "email": "test@pagsmile.com",
    *     "phone": "5491132463876"
      }

Note: 162************38 is pagsmile's test app id for sandbox, and MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ== is authorization token associated with the test app id.

Please use your own app_id and generate your own authorization token when testing.

PreviousArgentina NextWallet

Last updated 6 months ago