create
POST/v1/3ds
create
Request
- application/json
- application/x-www-form-urlencoded
Body
uuid
required | integer | min:1
required | string | in:USD,EUR,GBP,AUD,CAD,JPY,BYR,SGD,SHP,SKK,SLL,SOS,SRD,SSP,STD,SVC,SYP,SZL,THB,TJS,TMT,TND,TOP,TRY,TTD,TWD,TZS,UAH,AED,NAD,NGN,NIO,NOK,NPR,NZD,OMR,PAB,PEN,PGK,PHP,PKR,PLN,PYG,QAR,RON,RSD,RUB,RWF,SAR,SBD,SCR,SDG,SEK,ZMK,ZMW,BCH,BTC,JEP,GGP,IMP,XFU,GBX,CNH,EEK,GHS,LTL,LVL,MRO,MTL,TMM,JPY,ZWD,ZWL,ZWN,ZWR,VEF,UGX,UYU,UZS,VES,VND,VUV,WST,XAF,XAG,XAU,XBA,XBB,XBC,XBD,XCD,XDR,XOF,XPD,XPF,XPT,XTS,YER,ZAR,CDF,CHF,CLF,CLP,CNY,COP,CRC,CUC,CUP,CVE,CZK,DJF,DKK,DOP,DZD,EGP,ERN,ETB,FJD,FKP,GEL,GHS,GIP,AFN,ALL,AMD,ANG,AOA,ARS,AWG,AZN,BAM,BBD,BDT,BGN,BHD,BIF,BMD,BND,BOB,BRL,BSD,BTN,BWP,BYN,BZD,KWD,KYD,KZT,LAK,LBP,LKR,LRD,LSL,LYD,MAD,MDL,MGA,MKD,MMK,MNT,MOP,MRU,MUR,MVR,MWK,MXN,MYR,MZN,GMD,GNF,GTQ,GYD,HKD,HNL,HRK,HTG,HUF,IDR,ILS,INR,IQD,IRR,ISK,JMD,JOD,KES,KGS,KHR,KMF,KPW,KRW
required | string | credit_card
required | integer | min:1 | max:12
required | integer | min:2000
Body
required | string | credit_card
required | integer | min:1 | max:12
required | integer | min:2000
Responses
- 201
- 400
- 401
- 403
- 422
creates a card auth
- application/json
- Schema
- Example (from schema)
- Example
Schema
merchant
object
{
"id": "string",
"merchant": {
"id": "string",
"name": "string",
"arabic_name": "string",
"merchant_id": "string"
},
"status": "string",
"amount": 0,
"currency": "string",
"message": "string",
"failure_reason": "string",
"challenge_preference": "string",
"created_at": "string",
"updated_at": "string"
}
{
"id": "2a5f868f-90c2-49c1-895a-95aaaece17a6",
"merchant": {
"id": "0190442a-03e7-745d-8633-bc7a7f5c2fd6",
"name": "Merchant 1",
"arabic_name": "الإسم العربي",
"merchant_id": "6001"
},
"status": "available",
"amount": 100,
"currency": "SAR",
"return_url": null,
"message": "Authentication is available.",
"failure_reason": null,
"challenge_preference": "no_preference",
"is_frictionless": null,
"challenge": null,
"auth": null,
"created_at": "2024-06-23T08:15:22Z",
"updated_at": "2024-06-23T08:15:22Z"
}
authenticates a card
- application/json
- Schema
- Example (from schema)
- Example
Schema
{}
{}
returns unauthorized
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"message": "string"
}
{
"message": "Missing authentication information"
}
returns forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"message": "string"
}
{
"message": "Unauthorized"
}
returns unprocessable_entity
- application/json
- Schema
- Example (from schema)
- Example
Schema
errors
object
{
"message": "string",
"errors": {
"amount": [
"string"
],
"currency": [
"string"
],
"number": [
"string"
],
"month": [
"string"
],
"year": [
"string"
]
}
}
{
"message": "Data validation failed",
"errors": {
"amount": [
"This field is missing."
],
"currency": [
"This field is missing."
],
"number": [
"The value must be a proper credit/debit card number."
],
"month": [
"This field is missing."
],
"year": [
"This field is missing."
]
}
}